Scenario #9312: Newly Created Account for Existing Natural Person Should Be Able to View Existing Relations

Properties

Required

Given

name value
subjectName xyz-peter.smith

Expected

name value
expectedRelationsJson [
  {
    “type”: “REPRESENTATIVE”,
    “anchor”: { “tradeName”: “Peter Smith - The Second Hand and Thrift Stores-n-Shipping e.K.” },
    “holder”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “contact”: { “emailAddresses”: { “main”: “contact-admin@secondcontact.example.com” } }
  },
  {
    “type”: “PARTNER”,
    “anchor”: { “tradeName”: “Hostsharing eG” },
    “holder”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “contact”: { “emailAddresses”: { “main”: “contact-admin@sixthcontact.example.com” } }
  },
  {
    “type”: “DEBITOR”,
    “anchor”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “holder”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “contact”: { “emailAddresses”: { “main”: “contact-admin@thirdcontact.example.com” } }
  },
  {
    “type”: “SUBSCRIBER”,
    “mark”: “members-announce”,
    “anchor”: { “tradeName”: “Third OHG” },
    “holder”: { “givenName”: “Peter”, “familyName”: “Smith” },
    “contact”: { “emailAddresses”: { “main”: “contact-admin@thirdcontact.example.com” } }
  }
]

personUuid

HTTP GET "/api/hs/accounts/accounts" \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<xyz-peter.smith>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "242a0002-0000-0000-0000-000000000002", // Account: xyz-peter.smith
  "person" : {
    "uuid" : "367ffe5b-259a-465e-924d-8c71af07db0c", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "subject" : {
    "uuid" : "242a0002-0000-0000-0000-000000000002", // Account: xyz-peter.smith
    "name" : "xyz-peter.smith",
    "organization" : "xyz",
    "type" : "USER"
  },
  "globalUid" : 21011,
  "globalGid" : 21011
} ]

Fetch the account for the current subject to resolve the related person.

View their relations

HTTP GET "/api/hs/office/relations?personUuid=367ffe5b-259a-465e-924d-8c71af07db0c" // personUuid \
  -H "Authorization: Bearer $HSADMINNG_JWT_BEARER" \
  `# {` \
  `#   "sub" : "uuid<xyz-peter.smith>"` \
  `# }`
=> status: 200 OK 
[ {
  "uuid" : "c1998009-193a-49ac-bc59-84388fe396b4",
  "anchor" : {
    "uuid" : "ce7a2acb-db99-43f9-8a7e-0129a39c5138",
    "personType" : "LEGAL_PERSON",
    "tradeName" : "Peter Smith - The Second Hand and Thrift Stores-n-Shipping e.K.",
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "holder" : {
    "uuid" : "367ffe5b-259a-465e-924d-8c71af07db0c", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "type" : "REPRESENTATIVE",
  "mark" : null,
  "contact" : {
    "uuid" : "0124ef1a-74af-499b-a0f0-660c89687738",
    "caption" : "second contact",
    "postalAddress" : {
      "country" : "Germany"
    },
    "emailAddresses" : {
      "main" : "contact-admin@secondcontact.example.com"
    },
    "phoneNumbers" : {
      "phone_office" : "+49 123 1234567"
    }
  }
}, {
  "uuid" : "0b622799-e244-43dd-aa36-5836adc0b6df",
  "anchor" : {
    "uuid" : "367ffe5b-259a-465e-924d-8c71af07db0c", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "holder" : {
    "uuid" : "367ffe5b-259a-465e-924d-8c71af07db0c", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "type" : "DEBITOR",
  "mark" : null,
  "contact" : {
    "uuid" : "97798eb7-ab9b-4349-8831-f1cdb5e17520",
    "caption" : "third contact",
    "postalAddress" : {
      "country" : "Germany"
    },
    "emailAddresses" : {
      "main" : "contact-admin@thirdcontact.example.com"
    },
    "phoneNumbers" : {
      "phone_office" : "+49 123 1234567"
    }
  }
}, {
  "uuid" : "b60fb50a-f978-4519-b677-f8117d3a071f",
  "anchor" : {
    "uuid" : "c43762b4-0db7-4746-b9aa-a92736e26c49",
    "personType" : "INCORPORATED_FIRM",
    "tradeName" : "Third OHG",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "367ffe5b-259a-465e-924d-8c71af07db0c", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "type" : "SUBSCRIBER",
  "mark" : "members-announce",
  "contact" : {
    "uuid" : "97798eb7-ab9b-4349-8831-f1cdb5e17520",
    "caption" : "third contact",
    "postalAddress" : {
      "country" : "Germany"
    },
    "emailAddresses" : {
      "main" : "contact-admin@thirdcontact.example.com"
    },
    "phoneNumbers" : {
      "phone_office" : "+49 123 1234567"
    }
  }
}, {
  "uuid" : "de2f4402-2b26-4c4d-b20a-d5534ea9326f",
  "anchor" : {
    "uuid" : "c43fc218-ae0e-4d6d-afc9-528d9861c2eb",
    "personType" : "LEGAL_PERSON",
    "tradeName" : "Hostsharing eG",
    "salutation" : null,
    "title" : null,
    "givenName" : null,
    "familyName" : null
  },
  "holder" : {
    "uuid" : "367ffe5b-259a-465e-924d-8c71af07db0c", // personUuid
    "personType" : "NATURAL_PERSON",
    "tradeName" : null,
    "salutation" : null,
    "title" : null,
    "givenName" : "Peter",
    "familyName" : "Smith"
  },
  "type" : "PARTNER",
  "mark" : null,
  "contact" : {
    "uuid" : "d11a168c-3463-497d-8123-f64214875e21",
    "caption" : "sixth contact",
    "postalAddress" : {
      "country" : "Germany"
    },
    "emailAddresses" : {
      "main" : "contact-admin@sixthcontact.example.com"
    },
    "phoneNumbers" : {
      "phone_office" : "+49 123 1234567"
    }
  }
} ]

generated on 2026-08-10 04:42:19 for branch HEAD